home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 095 / rbbscnv.arc / CNVDIR.ARC / CNVDIR.DOC < prev    next >
Text File  |  1986-11-10  |  3KB  |  69 lines
  1. CNVDIR by Ken Goosens  8 November 1986
  2.  
  3. CNVDIR is a utility for converting pre-15.1A directory files into the
  4. format necessary for 15.1A.  Basically, it consolidates the many directory
  5. files into one.  The only directory file that MUST be converted is the
  6. upload directory - because this file is now read randomly.  For RBBS to
  7. work properly, the upload directory must be fixed length, have only
  8. file entries, and be in date order from oldest to newest.
  9.  
  10. You probably will want to convert all of your directory files into one
  11. because
  12.  
  13.   o  no longer will you have to move entries from your upload directory
  14.      into smaller files.
  15.  
  16.   o  you can dynamically change how the files are classified.
  17.  
  18.   o  you classify the uploads simply by loading the upload directory
  19.      into your favorite editor and adding a category code at the end
  20.      (3 bytes).
  21.  
  22.   o  file searches will run faster.  Especially N)ew.
  23.  
  24.  
  25. An example of a simple upload system is provided.  Copy all of these
  26. files into a subdirectory and run CNVDIR to see how it works.
  27.  
  28. DIR.CAT is the list of directories belonging to the upload management
  29. system.  This drives the conversion.  CNVDIR converts only those directories
  30. listed here.  It also inserts the category code provided in this file.
  31. Create this file before you convert so that you have your directory
  32. structure and codes laid out.   My production version of DIR.CAT (DIR.PRD)
  33. is provided as an example of how a complex directory structure can be built
  34. with composite categories.
  35.  
  36. GAMES.DIR, OS.DIR, and FILES.DIR are 3 sample upload directories in pre-151A
  37. format.
  38.  
  39. Type CNVDIR and you will get a screen of instructions and details.
  40. It will produce a file called UPLOADS.FIX.
  41.  
  42.  
  43. CAUTIONS
  44.  
  45. A good reason for not converting a directory file is that it is not to be
  46. stored in date order.  Eg. an alphabetical listing.
  47.  
  48. If the same file is listed in more than one directory, it will be listed
  49. multiple times in the converted directory.  You will have to edit out
  50. duplicates.
  51.  
  52. After converting, you must still sort the new upload directory by date.
  53. A good shareware program to do this is QSORT.  Version 2.1 is included
  54. with this release of CNVDIR.  (The command for this is
  55. QSORT UPLOADS.FIX /30:2 /27:2 /24:2).
  56.  
  57. Comments will be omitted from the new directory.  But they can be added
  58. back as text in DIR.CAT.
  59.  
  60. Files in the UPLOAD directory will be listed "backwards" physically but
  61. chronologically forward.  However, one case may require adjustment.
  62. When you have a multi-part file broken up into separate parts, RBBS will
  63. list the last first.  So the proper physical order in the file for a 4
  64. part file would be part 4, part 3, part 2, part 1 so that the order of
  65. reading and presentation would be 1,2,3,4.  Most people upload a 
  66. multi-part file in the order 1,2,3,4 which results in the stored order
  67. 1,2,3,4 rather than the needed 4,3,2,1.  A smaller problem, but you may
  68. want to rearrange such files.
  69.